home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 July / EnigmA AMIGA RUN 20 (1997)(G.R. Edizioni)(IT)[!][issue 1997-07 & 08][EAR-CD IV].iso / earcd / misc / emu / d32.lha / d32 / ASA Manual < prev    next >
Text File  |  1996-03-10  |  4KB  |  127 lines
  1.  
  2.                        ASA - A Simple Assembler
  3.                              by S.Goodwin
  4.                            Copyright 1994-6
  5.  
  6.  
  7. Abstract
  8.  
  9. This is a simple cross-assembler  for  creating  code to work with the
  10. 6809 Emulator, whilst running under the  Amiga's  CLI or shell. It can
  11. produce code (with or without headers) and a symbol file.
  12.  
  13.  
  14.                              -- Usage --
  15.  
  16. First, you must write  your  assembler  code  into  a plain ASCII text
  17. file. Then type 'asa file_name', where 'file_name' is the file name of
  18. your assembler code. This will then output:
  19.  
  20. ASA - A Simple Assembler - Copyright Steven Goodwin 1994-6
  21. Pass 1
  22. Pass 2
  23. Saving Code
  24. Saving symbols table
  25.  
  26.    The code will be saved into a  file  of  the same name, but with an
  27. '.6809' extension. When loaded into  the emulator, this assembler code
  28. will be placed (by default) at 20000 ($4e20).
  29.  
  30.    The symbols file will have the  '.sym' extension, and can be loaded
  31. through the symbols requester.
  32.  
  33.  
  34.    To get a full list of options available just type 'asa' on its own:
  35.  
  36. ASA - A Simple Assembler - Copyright Steven Goodwin 1994-6
  37.  
  38. asa [-cFILE] [-oNUM -bNUM -hC -sFILE -xC] filename <dest_fname>
  39.  
  40. Use "asa help" for a full description...
  41.  
  42.  
  43.    Using 'asa help', we get:
  44.  
  45. ASA - A Simple Assembler - Copyright Steven Goodwin 1994-6
  46.  
  47. asa [-cFILE] [-oNUM -bNUM -hC -sFILE -xC] filename <dest_fname>
  48.  
  49. -cFILENAME  Uses a particular configuration file.
  50. -oNUMBER    Specifies the origin of the assembled machine code.
  51. -sFILENAME  Save out symbol table with name.
  52. -bNUMBER    Sets a buffer size for the machine code produced.
  53. -h(y or n)  Include an assembler header.
  54. -x(y or n)  Remove original extension on source name?
  55.  
  56. If the filename starts 'file.' the source file is used, with the
  57. appropriate extension. The word 'screen' sends it to the terminal,
  58. and 'none' disables the option.
  59.  
  60.  
  61.                             -- Features --
  62.  
  63. o Free format assembly text  (i.e.  include spaces/tabs in most places
  64. and the system will *not* complain at you)
  65.  
  66. o Entire (??) instruction set has been implemented.
  67.  
  68. o Hard-wired  lexical  analyser  and  parser.  Whew!  That  took  some
  69. patience! But as a consequence it should be *very* fast.
  70.  
  71. o Works with full implementations of,
  72.     FCC   - allows text (within quotes) and byte data
  73.     FCB   - store data bytes into memory
  74.     FDB   - store words in memory
  75.     RMB   - leaves a gap of x bytes
  76.  
  77. o Label referencing forwards/backwards for all instructions.
  78.  
  79. o Saves in either 'memory  block'  or 'assembler snapshot' format. The
  80. latter containing a header indicatings its origin.
  81.  
  82. o Can use configuration files to specify set-up.
  83.  
  84.  
  85.  
  86. Non-Features (i.e. those I should have coded, but didn't!)
  87.  
  88. o The EQU op-code will only  produce  output  in the symbols file. The
  89. symbols themselves can not be used within the assembler file itself.
  90.  
  91. o No ORG op-code. Won't be  implemented  for  a while, due to the file
  92. format.
  93.  
  94. o Poor error handling.
  95.  
  96. o PC relative addressing with LEA is not featured.
  97.  
  98.  
  99.                              - Creation -
  100.  
  101. This was created (primarily) to  allow  me  to write and test routines
  102. for the 6809 emulator. However, it was deemed to be of use, and so was
  103. released with it. No guarantees are made for either piece of software,
  104. particularly as 99% of it  was  reverse  engineered from code examples
  105. from books, magazines and  my  own  personal collection. (apologies to
  106. .Kinn for losing your files :( )
  107.  
  108.    ASA was compiled by Philip Hart on SAS/C v 6.
  109.  
  110.  
  111.                         -- Copyright Notice --
  112.  
  113. The 'ASA' assembler is part of  the 6809e emulation system, comprising
  114. of the assembler and emulator.  The 'software' incorporates both parts
  115. of the system.
  116.  
  117. This software, and all its associated  documents, is copyright 1996 by
  118. Steven Goodwin. The version provided here may be freely distributed as
  119. long as no files  are  edited  or  deleted,  and  the copyright notice
  120. contained herein is not modified. No warranties, implied or otherwise,
  121. are given and this software  is  used  at  the  users own risk, and no
  122. liability can be accepted for  any  damaged caused, either directly or
  123. indirectly, from this software.
  124.  
  125.  
  126.  
  127.